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INTRODUCTION CHAPTER 1 



This manual describes GRAPHICS CP/M 2.2 revision 1.2.0. Use this 
manual with the Graphics CP/M Preface. 

Revision 1.2.0 differs from revision 1.1.0 in the following ways: 

o CP/M now supports 5-1/4 inch hard disk drives of various 
capacities. 

o Access speed to hard disk files has been increased. 

o The Graphics Manager now includes three additional 
geometric routines. 

o CPMGEN can now set the CP/M system disk to automatically 
execute a program named "AUTO.COM" when CP/M is loaded 
from floppy disk. 

o Errors CP/M encounters when you try to log onto a 

nonexistent disk drive do not cause the system to hang. 
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ABOUT THIS MAHUAL 



Section 1.1 



Information 
Covered in 
This Manual 



The utility programs used to install CP/M and the 
new geometric routines are described in this 
manual. Other CP/M utility programs and graphics 
routines are described in the Graphics CP/M 
Preface. 



Chapters 



Each chapter in this manual contains an 
introduction. Read the chapter introduction to 
determine which sections apply to your computer 
configuration. 



Procedures 



Procedures are included to guide you through the 
installation of CP/M and the use of the new 
geometric routines. 

Procedures contain step numbers and actions. The 
action column explains what to do and contains 
samples of what you can expect to see displayed on 
the screen. 
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INTRODUCTION 



TERMS USED IN THIS MANUAL 



Section 1.2 



Purpose 



The information given below explains terms that 
are used throughout this manual. Use this 
information to clarify the meaning of the text 
contained in this manual: 



DESCRIPTION 

CP/M 

[RETURN] 

[CONTROL] 
OTHER TEXT 



FACTORY 

MASTER 

DISK 

WORKING 
DISK 

DRIVE 1 



DRIVE 2 



HARD DISK 



EXPLANATION 

Means North Star Graphics CP/M. 

Means press the "RETURN" key on the computer 
keyboard. 

Means press and hold the [CONTROL] key on the 
keyboard, then type the key that follows 
[CONTROL] . 

Other information which is displayed in bold type 
should be typed on the computer keyboard. 

Means the floppy disk that is packaged with your 
copy of CP/M. 

Means a copy of the factory master disk. 



Means the top floppy disk drive in a two-drive 
system, the bottom floppy disk drive in a system 
with a hard disk. 

Means the bottom floppy disk drive in a two-drive 
system. 

Means a 5-1/4 inch hard disk drive. 
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INTRODUCTION 



CREATING A WORK COPY OF CP/M CHAPTER 2 

The method you use to create a work copy of CP/M depends on 
the type of computer you are using. 

IF YOUR COMPUTER. .. THEN.. . 

contains two floppy do the procedures in sections 2.1 f 2.2 
disk drives and 2.3 of this chapter. 

contains one floppy do the procedures in sections 2.1, and 
disk drive and one 2.3 through 2.9 of this chapter, 
hard disk drive 
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HOW TO LOAD CP/M Section 2,1 

Introduction This procedure explains how to load the CP/M 

operating system into the computer. CP/M must be 
loaded into the computer before you do any other 
procedures. 

Procedure 

STEP ACTION 

1 Turn on the power. The screen will display: 
LOAD SYSTEM 

2 Insert the CP/M factory master disk into disk drive 
number 1. 

3 Type [RETURN] . 

CP/M will be loaded into the computer's memory and will 
display: 

64K Graphics CP/M 2.2 rev 1.2.0 Advantage QD from 
North Star Computers, Inc. 

A> 
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HOW TO COPY THE FACTORY MASTER DISK ON Section 2.2 

A COMPUTER WITH TWO FLOPPY DISK DRIVES 

Purpose This procedure explains how to copy the factory 

master disk on a computer that has two floppy disk 
drives. Use the COPY program. The program uses 
both floppy disk drives to create the copy. 

Procedure 

STEP ACTI ON 

1 Insert a blank floppy disk into drive 2. 

2 Type COPY [RETURN] 

The program displays: 

Mount the Diskettes to be processed and- 

Enter INPUT Drive number (1-4): 

Or Mount System Diskette and RETURN to Exit: 

3 Type 1 [RETURN] 

The program displays: 

To Surface Check Only, Enter "N", 

To Verify-Compare two diskettes, Enter "V", 

To Copy, Enter OUTPUT Drive number (1-4): 

4 Type 2 [RETURN] 

The program displays: 

Proceeding to copy 70 track diskette 

5 The drive motors start and the information contained on 
the floppy disk in drive 1 is copied onto the floppy disk 
in drive 2. When the copy is complete, the program 
displays : 

Copy COMPLETE 

Mount the Diskettes to be processed and- 

Enter INPUT Drive number (1-4): 

Or Mount System Diskette and RETURN to Exit: 

6 Remove the factory master disk from drive 1 and store it 
in a safe place. 
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HOW TO COPY THE FACTORY MASTER DISK ON 



A COMPUTER WITH TWO FLOPPY DISK DRIVES (continued) 

Procedure 

STE P ACTION 

7 Remove the floppy disk from drive 2 and label it 

GRAPHICS CP/M RELEASE 2.2 VERSION 1.2.0 
WORK DISK 

8 Insert the work disk into drive number 1. 

9 Type [RETURN] 

The program displays: 
A> 
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THE WORK DISK Section 2.3 

Introduction The CP/M work disk that you made can be used on 
your computer without modification. This 
procedure explains how to generate a customized 
work disk. 



What is a A customized work disk contains a copy of the CP/M 
Customized system that has been tailored to a particular 
Work Disk computer configuration. 

When to There are four conditions that require the work 
Customize disk to be customized: 

1. You do not want CP/M to use the entire 
computer memory. 

CP/M normally uses the entire 64K of memory. 
The CP/M system program itself is located in 
the uppermost memory area. If you want to 
reserve any high memory for special purposes, 
such as unique input/output routines, then 
you need to create a CP/M system that uses 
less than 64K of memory. CP/M requires at 
least 54K of memory to operate. 

2. You have a printer attached to the serial 
interface card that uses a BAUD rate other 
than 9600 BAUD, or you have a printer 
attached to a parallel interface card. 

CP/M expects an SIO interface card to be 
installed in slot 1. The default BAUD rate 
is set to 9600 BAUD. 

3. You want CP/M to automatically load and 
execute an application program, such as 
MICROPLAN, whenever you load CP/M from floppy 
disk. 

CP/M enters the command mode after it is 
loaded. You can set CP/M to load and execute 
an application program automatically. 
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THE W OR K PISE (continued) 



How to 
Customize 
a Work Disk 



Use the table below to determine whether you need 
to create a customized work disk. 



IF ttt 



THEN.,. 



you want CP/M to use 
less than 64K of memory 

or 

your printer uses a 
BAUD rate other than 
9600 BAUD 

or 

your printer is 
attached to a parallel 
interface card 

or 

you want CP/M to 
automatically load 
and execute an 
application program 



do the procedure 
described on the 
next page 



your system requires 
specialized routines 
the input/output, or 
the interception of 
error messages 



refer to the Graphics 
CP/M Preface, Chapter 8 



you do not require a skip the remainder 
customized CP/M system Section 2 
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HOW TO CUSTOMIZE THE WORK DISK Section 2.4 

Introduction Use the CPMGEN program with your work disk to 

perform customization procedure. The program asks 
you to enter the "destination disk drive number", 
and to load the "output diskette". The 
destination disk drive number is 1. The output 
diskette is your work disk. 

Procedure 

STE P ACTION 

1 Insert your work disk into disk number 1. 

2 Type CPMGEN [RETURN] 

The program displays: 

North Star Graphics CP/M 2.2 System Generator 

Note: All responses end with RETURN, 
- (minus sign) restarts at question 1, 
CONTROL-C aborts to warm boot. 

Ql. Enter Memory Size in Kilobytes OR 
Simply type RETURN for 6 4K? 

3 If you want CP/M to use all 64K of memory, 
Type [RETURN] 

If you want CP/M to use less than 64K of memory, 

Type amount of memory [RETURN] 

(EXAMPLE: 54 [RETURN]) 

The program displays: 

Q2A. Enter Drive 1 Capacity (Q=Quad, RETURN=none) ? 

4 Type Q [RETURN] 

The program displays: 

Q3A. Enter Stepping Speed for Drive 1 (F=Fast, N=Normal)? 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Procedure 

STJEP ACTION 

5 Type F [RETURN] 

The program displays: 

Q2B. Enter Drive 2 Capacity (Q=Quad, RETURN=none) ? 

6 Type Q [RETURN] 

The program displays: 

Q3B. Enter Stepping Speed for Drive 2 (F=Fast, N=Normal)? 

7 Type F [RETURN] 

The program displays: 

Q2C. Enter Drive 3 Capacity (Q=Quad, RETURN=none) ? 

8 Type [RETURN] 

The program displays: 

Q4A. Is this a North Star HARD DISK System (Y or N) ? 

9 Type N [RETURN] 

The program displays: 

Q5. Do you want Read-Af ter-Write Check (Y or N) ? 

10 Type Y [RETURN] 

The program displays: 

Q6. Enter baud rate of serial printer (9600 to 300) 
(for parallel printer, enter RETURN? 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Procedure 

STEP A CT IO N 

11 If your computer contains a serial interface card (SIO) 
in slot l f 

Type baud rate [RETURN] 
(EXAMPLE: 9600 [RETURN] ) 

If your ADVANTAGE contains a parallel interface card (PIO) 
in slot 1, 

type [RETURN] 

If you want CP/M to use a printer that is attached to an 
interface card in slots 2, 3, 4, 5 or 6, you will need to 
create specialized input/output routines. The 
input/output routines are described in Chapter 8 of the 
Graphics CP/M Preface. 

The program displays: 

Q7. Do you want the program AUT0.COM automatically 
started when you Cold Boot (Y or N) ? 

12 If you want CP/M to automatically load and execute a 
program when it is initially loaded, 

Type Y [RETURN] 

otherwise, 

Type N [RETURN] 

The program displays: 

CPMGEN complete, the Herald for your version is: 

xxK Graphics CP/M 2.2 rev 1.2.0 Advantage QD from 
North Star Computers, Inc. 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Procedure 

ST£P &ZKQR 

13 Examine the herald which CPMGEN has displayed. Verify 
that the number xxK represents the amount of memory you 
want CP/M to use. 

If the amount of memory represented is incorrect. 

Type [CONTROL] C 

and go back to step 1. Otherwise, 

Type 1 

The program displays: 

Load output diskette in drive 1 

and RETURN to write CP/M system onto it? 

14 Type [RETURN] 

The drive motor starts and the customized CP/M is written 
onto your work disk. When the customization is 
complete, the program displays: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 

15 Type [RETURN] 

The program displays: 
LOAD SYSTEM 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Notes o If you told CPMGEN to automatically start an 

application program, then you must rename the 
program to "AUTO. COM" . Use the CP/M "REN" 
command to rename the program and place it on 
CP/M unit A: . 

(EXAMPLE: REN A :AOTO.COM= A: MI CROPLAN.COM) 

If CP/M does not find AUT0.COM during the boot 
process, the message "AUTO. COM?" will be 
displayed and CP/M will enter the command 
mode. 

o The installation of CP/M for your system is 

complete. The remainder of Section 2 applies to 
computers which contain a hard disk. Skip the 
remainder of this section. 
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how to copy the factwy MASTBR PISK QN Section 2,5 

A COMPUTER WITH ONE FLOPPY DISK DRIVE 

Introduction The CP/M "COPY" program cannot be used on a hard 

disk computer because it requires the use of two 
floppy drives. To create a CP/M work disk for your 
hard disk computer use the following programs: 

o FORMAT 
o ONECOPY 
o SYSGEN 
o CPMGEN 

The procedures for these programs are described in 
sections 2.6 through 2.9 
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HOW TO FORMAT A BLANK DISK 



Section 2.6 



Introduction 



A floppy disk that has never been used must be 
initialized before files can be stored on it. The 
initialization process is called formatting. 
Locate a new floppy disk and follow the procedure 
below. The disk drive in your computer is a 
"Quad-Capacity" disk drive. 



Caution 



The format program destroys any information that 
is contained on a floppy disk. The factory master 
disk should have a write-protect tab installed 
over the cutout on the right side of the disk. 
The write-protect tab ensures that the information 
stored on the disk cannot be destroyed. If the 
write-protect tab is missing, install one before 
you do this procedure. 



Procedure 

STEP ACTION 

1 Insert the work disk into drive 1. 

2 Type FORMAT [RETURN] 

The program displays: 

North Star Graphics CP/M 2.2.0 Diskette Formatter 
Initializes Diskettes for use with CP/M 

Select one of the format options below: 

D = Double-Density Single-Sided = D 
Q = Quad-Capacity (Double-Sided) = Q 
X = eXit - Warm Boot from A: = X 

Enter option letter (D,Q,X) : 

3 Type Q [RETURN] 

The program displays: 
Enter Drive number (1-4): 
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HOW TO FORMAT A BLANK DISK (continued) 



Procedure 

gTEp AC TION 

4 Type 1 [RETURN] 

The program displays: 

Load Diskette in Drive: 1, 

Strike RETURN <cr> when ready, 

To format as: Quad-Capacity Diskette: 

5 Remove the factory master disk from drive 1 and insert a 
blank disk. 

Type [RETURN] 

The program displays: 

- Proceeding to Format 70 * Tracks -... 

******************** 

• • • 

Diskette Successfully Initialized 

Select one of the format options below: 

D = Double-Density Single-Sided = D 
Q = Quad-Capacity (Double-Sided) = Q 
X = eXit - Warm Boot from A: = X 

Enter option letter (D,Q f X) : 

6 Remove the formatted disk from the drive 1. 

7 Insert the factory master disk into drive 1. 

8 Type X [RETURN] 

The program displays: 
A> 
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HOW TO OSE THE 'ONECOPY 1 PROGRAM 



Section 2.7 



Introduction 



The files contained on the factory master disk 
need to be copied onto the work disk. The 
"ONECOPY" program copies these files. 



Functional 



The ONECOPY program copies files in the following 
manner : 

1. Asks for the INPUT diskette to be mounted. 

2. Reads files from the INPUT diskette into the 
computer memory until the memory is full. 

3. Asks for the OUTPUT diskette to be mounted. 

4. Writes files from the computer memory onto the 
output diskette. 

5. Repeats steps 1 through 4 until all files have 
been copied. 



Notes 



The factory master disk is the INPUT disk. The 
the disk you formatted in the last section is the 
OUTPUT disk. 



Procedure 

STEP A CT IO N 

1 Insert the factory master disk into drive 1. 

2 Type ONECOPY [RETURN] 
The program displays: 

Mount INPUT Diskette and type RETURN 

3 Type [RETURN] 

The program displays: 

This program copies one or more files (ala PIP) between 

two diskettes alternately mounted in the logged-drive. 

Procedure : 

Enter a filename (may be wildcard like *..*) then Return 

The name is validated and staked in a list. 

To end the list and begin the actual copying, 

Enter a null line (simply a return) 

Enter filename (just RETURN begins copying) : 



2-15 GRAPHICS CP/M INSTALLATION 



HOW TO DSE THE 'ONECOPY' PROGRAM (continued) 

Procedure 

STEP ACTION 

4 Type *.* [RETURN] 

The program displays: 

Enter filename (just RETURN begins copying): 

5 Type [RETURN] 

6 The program will read some of the files contained from the 
factory master disk into the computer's memory. When the 
program is ready to write the files to the formatted 
disk, the program will display: 

Mount OUTPUT Diskette and type RETURN 

7 Remove the factory disk from the drive and insert the 
work disk. 

8 Type [RETURN] 

9 The program will write the files contained in the 
computer's memory onto the formatted disk. When all of 
the files have been written to the formatted disk, the 
program will display: 

Mount INPUT Diskette and type RETURN 

10 Remove the formatted disk from drive 1 and insert the 
factory master disk. 

11 Type [RETURN] 

12 Repeat steps 6 through 11 until the program displays: 
Mount SYSTEM Diskette and type RETURN 

13 Insert the factory master disk into the drive. 

14 Type [RETURN] 

The program displays: 
A> 
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HOW TO COPY THE SYSTEM INFORMATION TRACKS Section 2. 8 

Introduction The CP/M system controls the computer. The 

instructions that provide this control are stored 
on a portion of the factory master disk called the 
system tracks. The "ONECOPY" program does not 
copy the system tracks. Use the "SYSGEN" program 
to make the work disk a complete copy of the 
factory disk. 

Procedure 

STEP ACTION 

1 Insert the factory master disk into drive 1. 

2 Type SYSGEN [RETURN] 
The program displays: 

North Star Graphics CP/M 2.2 Sysgen 

Any response of CONTROL-C causes Warm Boot 

If System RAM Image already in RAM (@1400H) , Enter RETURN- 
To read System into RAM Image, Enter Drive number (1-4)? 

3 Type 1 [RETURN] 

The program displays: 

Load input diskette in drive 1 

and RETURN to read CP/M system from it? 

4 Type [RETURN] 

The drive motor starts and CP/M reads the system 
tracks into memory. The program displays: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 

5 Remove the factory master disk from the drive and insert 
the work disk. 
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HOW TO COPY THE SYSTEM INFORMATION TRACKS (continued) 

Procedure 

STEP ACTION. 

6 Type [RETURN] 

The drive motor starts and CP/M writes the system tracks 
onto the work disk. The program displays: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 

7 Type [RETURN] 

The program displays: 
LOAD SYSTEM 

8 Store the factory master disk in a safe place. 

9 Remove the work disk from the drive and label it: 

GRAPHICS CP/M RELEASE 2.2 VERSION 1.2.0 
WORK DISK 



2-18 GRAPHICS CP/M INSTALLATION 



HOW TO CU STOMIZE THE WORK DISK 



Section 2.9 



Introduction 



The CP/M system contained on the work disk must be 

customized before CP/M can use the hard disk. 

Use the CPMGEN program to customize the work disk. 

In this procedure, you specify: 

o The amount of system memory which CP/M will use 

o The name of the hard disk file which will 
contain the CP/M's hard disk connections 

o Whether CP/M will Automatically load and 

execute the file named "AUTO. COM" into memory 
when a cold boot is in process 



Note 



Procedure 



STEP ACTION 



If your computer system requires specialized 
routines for input/output or for the interception 
of error messages, consult the Section 8 of the 
Graphics CP/M Preface. 



If the work disk has a write-protect tab installed, remove 
the tab. Insert the work disk into the disk drive. 

Type CPMGEN [RETURN] 

The program displays: 

North Star Graphics CP/M 2.2 System Generator 

Note: All responses end with RETURN, 
- (minus sign) restarts at question 1, 
CONTROL-C aborts to warm boot. 



Ql . Enter Memory Size in Kilobytes OR 
Simply type RETURN for 6 4K? 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Procedure 

£T£P hZHQR 

2 If you want CP/M to use all 6 4K of memory. 
Type [RETURN] 

If you want CP/M to use less than 64K of memory , 
Type amount of memory [RETURN] (EXAMPLE: 60 [RETURN]) 
NOTE: CP/M requires at least 54K of memory to operate. 
The program displays: 
Q2A. Enter Drive 1 Capacity (Q=Quad, RETURN=none) ? 

3 Type Q [RETURN] 

The program displays: 

Q3A. Enter Stepping Speed for Drive 1 (F=Fast, N=Normal)? 

4 Type F [RETURN] 

The program displays: 

Q2B. Enter Drive 2 Capacity (Q=Quad, RETURN=none) ? 

5 Type [RETURN] 

The program displays: 

Q4A. Is this a North Star HARD DISK System (Y or N) ? 

6 Type Y [RETURN] 

The program displays: 

Q4B. Give the PATHNAME of the HARD DISK Work File OR 
Simply type RETURN for "CPMWORK"? 

7 Type [RETURN] 

Q5. Do you want Read-Af ter-Write Check (Y or N)? 
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HOW TO CUSTOMIZE THE WORK DISK (continued) 



Procedure 

STfiP ACT ION 

8 Type Y[RETORN] 

The program displays: 

Q6 . Enter baud rate of serial printer (9600 to 300) 
(for parallel printer, enter RETURN? 

9 If your computer has a serial interface (SIO) card in 
slot 1: 

Type baud rate [RETURN] 
EXAMPLE: 9600 [RETURN] ) 

If your computer has a parallel interface (PIO) card in 
slot 1: 

type [RETURN] 

The program displays: 

Q7 . Do you want the program AUTO.COM automatically 
started when you Cold Boot (Y or N) ? 

10 If you want CP/M to automatically load and execute an 
application program when it is first loaded from the 
floppy disk: 

Type Y [RETURN] 

otherwise : 

Type N [RETURN] 

The program displays: 

CPMGEN complete, the Herald for your version is: 

xxK Graphics CP/M 2.2 rev 1.2.0 Advantage HQ from 
North Star Computers, Inc. 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 
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HOW TO COSTQMIZE THE WORK DISK (continued) 



Procedure 

STEP AC TION 

11 Examine the herald which CPMGEN has displayed. Verify 
that the number xxK represents the amount of memory you 
want CP/M to use. 

If the amount of memory represented is incorrect: 

Type [CONTROL] C 

and go back to step 1. Otherwise: 

Type 1 

The program displays: 

Load output diskette in drive 1 

and RETURN to write CP/M system onto it? 

12 Type [RETURN] 

The drive motor starts and the customized CP/M system is 
written onto your work disk. The program displays: 

Enter Destination Disk Drive number (1-4)- 
or RETURN to Cold-Boot from drive 1- 
or CONTROL-C to Warm-Boot ? 

13 Type [RETURN] 

The program displays: 
LOAD SYSTEM 
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HQW TO CR EATE CP/f* B A ftD DISK PNITS 



Section 2,10 



Introduction 



A CP/M hard disk unit is a file stored on the hard 
disk. Do this procedure to: 

o Create CP/M files on the hard disk 

o Create a connection table which associates both 
the hard disk CP/M files and the floppy disk 
drive with drive designations 

Before continuing with this procedure read the 

Graphics CP/M Preface, Sections 9.1 through 9.4 

and all of Section 10. These sections will help 
you to understand: 

o How to choose file sizes 

o How to create files on the hard disk 

Continue with this section after you have read the 
information mentioned above. 



Procedure 

STEP ACTION 

1 Reset your computer so that you see: 
LOAD SYSTEM 

2 If the work disk has a write-protect tab installed, remove 
the tab. Insert the CP/M work disk into the disk drive. 

3 Type [RETURN] 

The program displays: 

Hard Disk Boot In-Process 

To review connections, enter Semicolon (;) within a second 

or two 



■Current Connections in workfile: CPMWORK 
•ENTER A CONNECTION or T=To HDOS or 
S=SAVE or X=EXIT? 
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HQW TO CR EA TE CP/ H H A RP PISS U NITS (continued) 

Procedure 

STEP ACTION 

4 Type T [RETURN] 

The program displays: 

Entering HDOS (slight delay) to CReate "units", etc. 
When finished, return to CP/M HDBOOT process with 
command "CP" 

North Star Hard Disk Operating System, Subset V2.1.0 



5 Determine the file names, sizes, and allocation factors 
for your CP/M hard disk units. This information is 
contained in the Graphics CP/M Preface, Sections 9.1 
through 9.4. 

6 Create a CP/M unit: 

Type CR filename size allocation-factor [RETURN] 
(EXAMPLE: CR CPMUNITA 4096 4 [RETURN]) 

7 Repeat step 6 until you have created all of the CP/M units 
that you will require. 

8 Type CP [RETURN] 
HDOS will display: 



•Current Connections in workfile: CPMWORK 
•ENTER A CONNECTION or T=To HDOS or 
S=SAVE or X=EXIT? 
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HOW TO CREATE CP/M HARD DISK DNITS (continued) 

Procedure 

STEP ACTION 

9 Enter your CP/M connections: 

Type letter : filename [RETURN] 
(EXAMPLE: A :CPMDNITA [RETURN] 

The program displays: 

Current Connections in workfile: CPMWORK 

A:CPMUNITA 

ENTER A CONNECTION or T=To HDOS or 

S=SAVE or X=EXIT? 



10 Repeat step 11 until you have entered a connection for 
each CP/M hard disk unit. 

11 Enter a connection for the floppy disk drive: 

Type letter : f l[RETURN] 
(EXAMPLE: M: ,1 [RETURN] ) 

The program displays: 

Current Connections in workfile: CPMWORK 

A:CPMUNITA 



M: ,1 

ENTER A CONNECTION or T=To HDOS or 

S=SAVE or X=EXIT? 



12 Type S [RETURN] 

The program displays: 

64K Graphics CP/M 2.2 revision 1.2.0 Advantage HD 
North Star Computers Inc. 
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HOW TO COPY FILES INTO CP/M HARD DISK UNITS Section 2.11 

Introduction You created CP/M hard disk units and assigned 

connection letters to them in Section 2.8. You 
also assigned a connection letter to your floppy 
disk drive. V7hen CP/M is loaded from floppy disk, 
it logs into unit "A". If you assigned CP/M unit 
"A" to a hard disk file, copy the files from your 
work disk onto unit "A". 

Procedure 

STEP ACTION 

1 Log onto the floppy disk drive: 

Type unit: [RETURN] (EXAMPLE: M: [RETURN]) 
The drive motor starts and the screen displays: 
M> 

2 Copy the files: 

Type PIP A: =M:*.* [RETURN] 

The program copies the files from the floppy disk into 
unit "A". The name of each file is displayed as the file 
is copied. When the program displays: 

M> 

3 Type A: [RETURN] 

to log onto unit "A". To verify that unit "A" contains 
the system files: 

4 Type DIR [RETURN] 

The program displays a list of files: 

CPMGEN.COM SYSGEN.COM C0PY.COM HDB00T.COM 

USER. ASM GMGRADD.COM ED.COM PIP.COM 

The installation of CP/M for your system is complete. 
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HOW TO MODIFY HARD DISK CONNECTIONS Section 2.12 

Introduction You may want to modify your hard disk connections 

eventually to add or delete units, extend file 
sizes, or change connection letters. You can 
cause CP/M to stop at the hard disk connection 
table when CP/M is being loaded from floppy disk. 

Procedure 

STEP A C T ION 

1 Reset the computer. The computer displays: 
LOAD SYSTEM 

2 Insert the CP/M work disk into the drive. 
Type [RETURN] 

3 When CP/M displays the message: 

Hard Disk Boot In-Process 

To review connections, enter Semicolon (;) within a second 

or two 

4 Type ; 

CP/M pauses at the connection table and displays: 

Current Connections in workfile: CPMWORK 

A:CPMUNITA 



M:,l 

ENTER A CONNECTION or T=To HDOS or 

S=SAVE or X=EXIT? 

Follow steps 4 through 14 of the procedure given in 
Section 2.8 to make your modifications and save the new 
connection table. 
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GRAPHICS CHAPTER 3 

The Graphics CP/M disk contains two graphics utility programs: 

o GDDT 

o GMGRADD 

These programs allow you to create programs which can make use of 
the graphics features of the computer. 

GMGRADD appends a copy of North Star's Graphics Manager to 
programs. 

GDDT (Graphics Dynamic Debugging Tool) contains copies of Digital 
Research's DDT (Dynamic Debugging Tool) and the North Star 
Graphics Manager. 

GDDT was created for two reasons: 

1. To allow graphics programs to be tested and debugged before 
the Graphics Manager is appended to them. 

2. Because both GDDT and the Graphics Manager use of the same 
memory area in a hard disk system and, therefore, cannot be 
loaded in memory together. 
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HOW TO USE GDDT Section 3.1 

When to Use Use GDDT when you want to test or debug a 
GDDT program that makes calls to the Graphics 

Manager . 

Note If you have run GMGRADD against a program, do 

not use the program with GDDT. 

Procedure 

STEP ACTION 

1 Create an assembly-language source code file using a text 
editor. This file must have a file type of ".ASM". 

2 Assemble your program using the CP/M program "ASM.COM". 
During the assembly process, "ASM" creates an intermediate 
file with a file type of ".HEX". You use the ".HEX" file 
with GDDT. 

3 Load GDDT 

Type GDDT [RETURN] 

The program displays: 
DDT VERS 2.2 



4 Specify the name of the input ".HEX" file with the DDT "I" 
command : 

Type If ilename . hex [RETURN] 
(EXAMPLE : IGRAPH. HEX [RETURN] ) 

NOTE: The ".HEX" file must be contained on the currently- 
logged CP/M unit. 

5 Read the file into memory with the DDT "R" command: 
Type R [RETURN] 

6 Use the DDT commands described in Digital Research's DDT 
manual. 

7 When you finish using GDDT, exit to the CP/M command 
level : 

Type GO [RETURN] or [CONTROL] C 
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DESCRIPTION OF GMGRADD 



Section 3.2 



Introduction 



When to 
Use GMGRADD 



What GMGRADD 
Does 



Functional 
Description 



To conserve memory space, the Graphics Manager 
does not permanently reside in memory. It is 
loaded only when it is needed. GMGRADD is used to 
add graphics capability to machine-language 
programs. 

Use GMGRADD any time you create a machine- 
language program that calls to the Graphics 
Manager entry point at memory address 000CH. 

GMGRADD performs the following functions: 

o It adds a copy of the Graphics Manager to the 
end of your program file. 

o It moves the first three bytes of your program 
to a special area of the program file. 

o It places a jump instruction, which points to 
the Graphics Manager loader, at the beginning 
of your program. 

After the Graphics Manager has been added to 
your program, the following process occurs 
each time you run your program: 

1. When CP/M loads your program into memory, the 
jump instruction at memory address 0100H 
causes control to be passed to the Graphics 
Manager loader. 

2. The Graphics Manager loader shrinks the 
amount of memory available for use by your 
program to make room for itself. 

3. The Graphics Manager relocates itself in high 
memory, just below the CP/M system. 

4. The Graphics Manager restores the first three 
bytes of your program to memory addresses 
0100H-0103H. 

5. The Graphics Manager transfers control to 
your program at memory address 0100H. 
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HQW TO PSB CHSR A P P Section 3,3 

Introduction Do this procedure to add the Graphics Manager to 

your program. 

Procedure 

STEP ACTION 

1 Create a program with a text editor such as ED or 
WORDSTAR. 

2 Assemble the program with the "ASM" program or another 
assembler. 

3 Load the program with the "LOAD" program or another 
loader. 

4 Type GMGRADD drive: filename [RETURN] 

(EXAMPLE: GMGRADD B : GRAPH [ RETURN ] ) 

After the Graphics Manager has been added to the file, the 
program will display: 

GRAPHICS MANAGER HAS BEEN APPENDED TO YOUR COM FILE 



Notes: o GMGRADD modifies program files and should only 

be used once with a file. 

o GMGRADD can be used only with files that have 
a file type of ".COM". COM files contain 
machine-language instructions that CP/M loads 
directly into the computer's memory at address 
0100H. 

o Once GMGRADD has been run against a program, 
the program cannot be debugged with GDDT. 
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ADDITIONAL GEOMETRIC RODTINES 



Section 3.4 



Introduction 



The Graphics Manager distributed with Graphics 
CP/M 2.2 Release 1.2.0 includes three additional 
geometric routines: 

o EXTENDED POLYGON 
O EXTENDED RECTANGLE 
O EXTENDED ELLIPSE 

The original geometric routines are still 
recognized by the Graphics Manager. This 
makes previously-written programs compatible 
with Release 1.2.0. The Graphics CP/M Preface 
manual describes the original routines and how 
they are used. 



Description 



The extended routines are described below: 



Polygon 

and 

Rectangle 



Polygons and rectangles can be rotated around 
the axis of an x-y pivot point with the 
extended routines. The numeric value for the 
rotation may be within the range of -32768 to 
32767 degrees. If the value exceeds 360, then 
360 is subtracted from the value. Subtraction 
continues until the value is less than or 
equal to 360. 



Ellipse 



The extended ellipse routine accepts numbers 
in the range of to 65535 for the radii 
values. Ellipses may be rotated around the 
axis of an x-y pivot point. The numeric 
value for the rotation may be within the range 
of -32768 to 32767 degrees. If the value 
exceeds 360, then 360 is subtracted from the 
value. This subtraction is repeated until the 
remaining value is less than or equal to 360. 
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GRAPHICS 



Z-8Q CPP REGISTERS Section 3.5 

Registers The Z80 CPU contains two sets of registers. The 

first set, called the primary registers, are named 
A f B, C, D, E r H, L, IX f and IY. The second set, 
called the alternate registers, are named AF', 
BC, DE', and HL 1 . The original geometric 
routines use the primary registers A, B f C, D, E, 
H f L, IX, and IY, The extended geometric routines 
the same primary registers plus the alternate 
registers BC*, DE' and HL 1 . 

Loading Values cannot be loaded directly into the 
Values alternate registers. To load the alternate 

registers, place the values into the standard 
registers (BC, DE, and HL) , then issue the Z80 
assembly language instruction n EXX n . This 
instruction, represented by the hexidecimal value 
D9 , causes the values in the BC, DE, and HL 
registers to be exchanged with the values in the 
BC, DE 1 , and HL ' registers. After the alternate 
register values are loaded, load the values for 
the primary registers. 
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GRAPHICS EXAMPLES 



Section 3.6 



Purpose 



The graphics examples which follow illustrate the 
programming differences between the original and 
extended graphics routines. The program listings 
of the extended routines contain areas of code 
that are screened. These areas identify the code 
that was changed from or added to the original 
programs. 



Hard Copy 



Options 
Required 



The Graphics Manager contains a routine which can 
copy an image from the computer display to a dot 
matrix printer. This routine is invoked by typing 
CONTROL-T on the computer keyboard. To use this 
routine, you must have one of the following 
printers attached to a serial interface card in 
slot 1 of your computer: 

o North Star NS-100 
o Epson MX-80 
o Epson MX-100 

The printer must contain the GRAFTRAX option. 
If the printer contains a serial interface card, 
the card must contain a buffer of at least 2K. 



Printer 



Returning 
to CP/M 



The Demo/Diagnostic diskette shows how to set 
the switches on an Epson 8145 serial interface 
card. This information is located in the 
explanations section. 

Each of the example programs draws an image on 
the computer display and waits for you to type a 
key. At this point a [CONTROL] T causes the 
display to be copied to the printer. Typing any 
other key causes the program to return to the 
CP/M command level. After typing a [CONTROL] T, 
wait for the printed copy to be completed, then 
type another key to exit from the program. 
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EXTENPEP POLYGON DES CRIPT I O N 



Section 3.7 



Introduction 



REGISTER 


VALUE 


A 


9 


B 


1 to 64 


C 


Command byte 


HL 


Table address 


IX 
IY 


Extra buffer 
address 

) 
Extra buffer size 


BC 


x pivot point 



This section describes how to set the registers 
for the extended polygon routine. Additional 
information is contained in Section 6.3 of the 
Graphics CP/M Preface. 



D E SCR IPTION 

Designates the extended 
polygon routine 



See the Graphics CP/M 
Preface for a 
description of values 
used with these registers 



The horizontal coordinate 
around which rotation is 
to occur 



DE' 



y pivot point 



The vertical coordinate 
around which rotation is 
to occur 



HL 



Rotation angle 



A value within the range 
of -32768 to 32767 
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EXAMPLE 1 - POLYGON DSING REGULAR ROUTINE 



Section 3,8 



0100 

oooc = 

0001 = 
0005 = 



0100 3E02 
0102 0EC1 

0104 212301 

0107 CD0C00 

010A 3E01 

010C 0606 
010E 0E51 

0110 212B01 

0113 CD0C00 



0116 0E01 
0118 CD0500 

011B FEOO 

011D CA1601 

0120 C30000 



0123 0000 
0125 0000 
0127 7F02 
0129 EFOO 



ORG 


00100H 


GRAF EQU 


0000CH 


CINP EQU 


001H 


BDOS EQU 


00005H 


;Set the vi 


ewport a 


SETVP MVI 


A,002H 


MVI 


C,0C1H 


LXI 


H,VP 


CALL 


GRAF 



;Graphics Manager 
;entry point 

;Character input routine 
;CP/M BDOS entry point 



Select rectangle routine 

Command byte for 

viewport with border 

Point HL to viewport 

coordinates 

Call Graphics Manager 



;Select original 
/polygon routine 
;Specify 6 sides 
;Value for shading 
;the interior 
;Point HL to 
;polygon coordinates 
;Call Graphics Manager 



;Loop through this routine until the user 
; types a key on the keyboard. Then return 
;to CP/M 



;Draw a polygon 
DRAW MVI A,001H 



MVI 


B,006H 


MVI 


C,051H 


LXI 


H,POLYG 


CALL 


GRAF 



LOOP MVI C f CINP 

CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to CP/M input code 

Call CP/M to get 

a character 

If zero, no key 

was typed 

If no key was 

typed, loop 

Re-enter CP/M 

via warm boot 



;These values are the coordinates for the 
/viewport 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;x 


maximum 


DW 


00EFH 


;Y 


maximum 
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EXAMPLE 1 - POLYGON DSING REGULAR ROUTINE (continued) 



;These values are the coordinates for the 
;polygon 



012B 


1701 


012D 


4F00 


012F 


6701 


0131 


4F00 


0133 


8F01 


0135 


7700 


0137 


6701 


0139 


9F00 


013B 


1701 


013D 


9F00 


013F 


EF00 


0141 


7700 



POLYG 



DW 


0117H 


?X1 


DW 


004FH 


?Y1 


DW 


0167H 


?X2 


DW 


004FH 


?Y2 


DW 


018FH , 


?X3 


DW 


0077H 


?Y3 


DW 


0167H 


?X4 


DW 


009FH , 


■Y4 


DW 


0117H j 


•X5 


DW 


009FH j 


■Y5 


DW 


00EFH j 


X6 


DW 


0077H j 


•Y6 



«IIIMIIIWW»W»»mWWW»»* 



/*x4>x*x*x*x+x*x*x+x«& 



,<«ux*x*x*x*x«+x 



..mfc 



/»x«xlx«x»x*x<»x»xwx«x4x*x4xmxft 

#X«XtX*XM*XtXJXtX?X««JX«*XtX*xV 

mx*xmx*x*xSxmx*x+x?x*x*x*x<>xSxfc 
«*x*x?x«x*x*x*x*x«?x?x*xtxmx««?X!, 
mxmxmxmxtxmxmxwxmxtro 



•<*X?X»X*X*X««*X»X*X*X*X*X«JX«?Xt)' 

^»X♦X♦X♦X♦X♦X♦X♦X♦X*X♦X*X♦X♦X*X*X♦/ 
K«X«*X»X*XJX»X»X*X*X»X*X««M»)/ 

umx+x*xM*x*x«t«c*x*x«xmx*y 

WX*X*X«*X$X*X«*X*X*X«(*XW 



Wmxmx+mmxmX+xmxV 
*XmX*X««M*X?XmX»X»Xf 
VX*X*X*X*X*X«*X*XtX»X+X*f 



tmx*x*x*x*xmx*x*x*x*>' 
smx«*x«*xmx+x*x*/ 

\mmmwmr 



FIGURE 1 
REGULAR POLYGON 
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EXAMPLE 2 - POLYGON USING EXTENDED ROUTINE 



Section 3.9 



0100 

oooc 


= 


ORG 
GRAF EQU 


OOIOOH 
OOOOCH 


0001 
0005 


= 


CINP EQU 
BDOS EQU 


001H 
00005H 






;Set the viewport and c 


0100 
0102 


3E02 
0EC1 


SETVP MVI 
MVI 


A,002H 
C,0C1H 


0104 


212D01 


LXI 


H f VP 


0107 


CD0C00 


CALL 


GRAF 






;Draw a polygon rotated 


010A 
010D 


013F01 
117700 


DRAW LXI 
LXI 


B,013FH 
D,0077H 


0110 
0113 


215A00 
D9 


- Li AX 

DB 


H,90 
0D9H 


0114 


3B09 


'MVI 


" A,009H * 


0116 
0118 


06 06 
0E51 


MVI 
MVI 


B,006H 
C,051H 


011A 


213501 


LXI 


H,POLYG 


011D 


CD0C00 


CALL 


GRAF 



0120 0E01 
0122 CD0500 
0125 FE00 
0127 CA2001 
012A C30000 



;Graphics Manager 
;entry point 

/•Character input routine 
;CP/M BDOS entry point 



;Select rectangle routine 
; Command byte for 
;viewport with border 
;Point HL to 
;viewport coordinates 
;Call Graphics Manager 



;Rotation will occur 
jaround the center of 
; the screen 
^Rotate 90 degrees 
! .•; Move values to 
I ; al ter na te r egi s t e r s 
|; Select extended ''-* 
/polygon routine 
•Specify 6 sides 
;Value for shading 
;the interior 
;Point HL to 
;polygon coordinates 
;Call Graphics Manager 



;Loop through this routine until the user 
; types a key on the keyboard. Then return 
;to CP/M 



LOOP MVI C,CINP 

CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to 
CP/M input code 
Call CP/M to 
get a character 
If zero, no 
key was typed 
If no key was 
typed, loop 
Re-enter CP/M 
via warm boot 
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EXAMPLE 2 - POLYGON DSING EXTENDED ROUTINE (continued) 



;These values are the coordinates for the 
;viewport 



012D 0000 
012F 0000 
0131 7F02 
0133 EF00 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;x 


maximum 


DW 


00EFH 


;Y 


maximum 



;These values are the coordinates for the 
; polygon 



0135 


1701 


0137 


4F00 


0139 


6701 


013B 


4F00 


013D 


8F01 


013F 


7700 


0141 


6701 


0143 


9F00 


0145 


1701 


0147 


9F00 


0149 


EF00 


014B 


7700 



POLYG 



DW 


0117H 


;xi 


DW 


004FH 


?Y1 


DW 


0167H 


;X2 


DW 


004FH 


;Y2 


DW 


018FH 


•X3 


DW 


0077H 


fY3 


DW 


0167H 


•X4 


DW 


009FH , 


•Y4 


DW 


0117H 


•X5 


DW 


009FH , 


■Y5 


DW 


00EFH , 


■X6 


DW 


0077H 


-Y6 



014D 



END 
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EXAMPLE 2 - POLYGON USING EXTENDED ROUTINE (continued) 



X AXIS PIVOT 




?X?XmX*X»X»X«XmX?X" 



90° ROTATION 



.iiffxmxmxmxmxtxtxmx-H 
,.. «!?x*x*x*x»xmx«M*xmxtx*x< ., . .. . ... 

♦xmx*x?x*xmx*x?x*x?x*xmx«Mix»! 



rfiflxmx*x+x»x*XM«M«mx*xmx« 

x?xmx*x?x*xmx*x?x*x?x*xmx«M , 

:*x*xmx*xmx«*x?x««*x*xmx*xmxf 

X*X*X«X*XtXWX*XmxmX*X*X*X«XmX*X' 

ixmx*x*x*xmxmx«?x*x«mx«mx« 
♦x«mx*x*x*x*XM*x«?x*xmx?x*xmx« 
xmx»x«Sx3x*xtxtxix»xmxmx»x+ii»x+x 



♦x+x*x*xmx*x*xm 



xmxtx*x»xmx*x*xixmx*x*xtx«xmxtx 

♦X*X«WX*)WXM«Xm* 

x«*xmx«mx*x*x.. 

■ "♦XtX+XmX*X*Xmt+X*X*X«*XM*Xmjj 



♦x*x«mx*x»x«m 

"«X«X4XtX+X4X«XtX»Xi 

xmxmxmxmx* 



Y AXIS PIVOT 



FIGURE 2 
ROTATED POLYGON 
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EXTENDED RECTANGLE DESCRIPTION 



Se<?UQn 3.10 



Introduction 



REG ISTE R 
A 



HL 
BC 

DE 1 

HL' 



This section describes how to set up the registers 
for the extended rectangle routine. Additional 
information is contained in Section 6,3 of the 
Graphics CP/M Preface. 



VAEUE 
10 

Command byte 

Table address 
x pivot point 

y pivot point 

Rotation angle 



DESCRIPTION 

Designates the extended 
rectangle routine 

See the Graphics CP/M 
Preface manual for a 
description of values 
used with these registers 

The horizontal coordinate 
around which rotation is 
to occur 

The vertical coordinate 
around which rotation is 
to occur 

A value within the range 
of -32768 to 32767 
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EXAMPLE 3 - RECTANGLE USING REGULAR ROUTINE 



Section 3.11 



0100 






ORG 


00100H 


oooc 


= 


GRAF 


EQU 


0000CH 


0001 


ss 


CINP 


EQU 


001H 


0005 


= 


BDOS 


EQU 


00005H 






;Set 1 


the viewport a 


0100 


3E02 


SETVP 


MVI 


A f 002H 


0102 


0EC1 




MVI 


C r 0ClH 


0104 


212101 




LXI 


H f VP 


0107 


CD0C00 




CALL 


GRAF 






;Draw 


a rectangle 


010A 


3E02 


DRAW 


MVI 


A,002H 


010C 


0E51 




MVI 


C,051H 


010E 


212901 




LXI 


H,RECT 


0111 


CD0C00 




CALL 


GRAF 



0114 0E01 
0116 CD0500 

0119 FEOO 

011B CA1401 

011E C30000 



0121 0000 
0123 0000 
0125 7F02 
0127 EFOO 



;Graphics Manager 
;entry point 

/•Character input routine 
;CP/M BDOS entry point 



;Select rectangle routine 
/•Command byte for viewport 
;Point HL to 
;viewport coordinates 
;Call Graphics Manager 



;Select original 
/•rectangle routine 
;Value for shading 
;interior 
;Point HL to 
;rectangle coordinates 
;Call Graphics Manager 



;Loop through this routine until the user 
;types a key on the keyboard. Then return 
;to CP/M 



LOOP MVI C,CINP 

CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to CP/M input code 

Call CP/M to 

get a character 

If zero, no key 

was typed 

If no key was 

typed, loop 

Re-enter CP/M 

via warm boot 



;These values are the coordinates for the 
/•viewport 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;x 


maximum 


DW 


00EFH 


;Y 


maximum 
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EXAMPLE 3 - RECTANGLE USING REGULAR ROUTINE (continued) 



;These values are the coordinates for the 
; rectangle 



0129 
012B 
012D 
012F 



B000 
6000 
D001 
9000 



RECT 



DW 


00B0H 


;xi 


DW 


0060H 


;Y1 


DW 


01D0H 


;X2 


DW 


0090H 


;Y2 



0131 



END 



I II I II I II I II I II I II I II I II I II I HI II I II I II I II III II I I I I II I II I II I II W WflWW* 

[♦x««i«*x«tM*xmx*XM*x»xtxmx«*xmx*x«ttxmxtx+xmxM*xmxm 

MX*X»X*xmX*X+X*X*X*X*X*Xmx*X»X*X*X*X»XMmX*X*X?X*X*XmxmX«*X 

ttx+xmxmxtxmx4x»x+xtx4x+xmxtx4X4X*X4X4x*x«x4xmx4xtxtxmx»xm 
wx*xMmxMmx*x*x*x*x*x*xmxM*xmxMM*x*x*x«mx*xwx*x*x+x$x 

>XmXMX*X*X*X*X*X«XmX*X*X?X*xmX*X*X»XmXM*X*X*X+X4X4Xmx*X+X$X 
(♦X*XmxmX+XmX*XmX+X*X+XmX«*X«mxmX«mX*XWXmXmXtX* 

w*x*x*x*x«xmx*xmx*x*xmxmx*xtx«*xmx*x+x*xmxmxmxmx*x*x 
t*x*x?x?xmx*x*xmxmx*xmxmxmx*x+x+xmxmxmx*x*xmx7X«+x4i 
^♦x»xSx+x+xtx+x?x*x4x*xtx»x*x*x+x*xtx+xtx*x?x*x*x»x*x»X4xSx?xtx+x«*x¥x 

(♦X»X*XmX«MX*X+X*X*XmxmX*X*X*XmX*XmX+XmX+XMX*X*X«»Xm 
>XmX«WX*X*X?X+XM*xmX*X*X*X*X*X+X*X*X*XmX+X*XmX*xmXM«xmXJX 
:tX4X4X4XtXtX4XmXtX+X«XtXtX4X4X4X4X4XtX*X4XtX4XtXmX4X4X4X4X4XtX4XtX4 
rX*X*XmX*XM*X+Xmx+XmX+X*xmX*X*X+XMMXmX*X*xmX*X*XMXmx 
(♦X*XM«mXmXmX«MX*X*X*X*X*X*X*XmX*X*XmX*X*XmX*XM*X*X$X* 
" ■ " f " ■ •" 



FIGURE 3 
REGULAR RECTANGLE 
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EXAMPLE 4 - RECTANGLE USING EXTENDED ROUTINE 



Section 3.12 



0100 

oooc 


= 


0001 
0005 


= 


0100 
0102 


3E02 
0EC1 


0104 


212B01 


0107 


CD0C00 


010A 


014001 


010D 


117800 


0110 
0113 


212D00 
D9 


0114 


3E0A 


0116 


0E5l" 


0118 


213301 


011B 


CD0C00 



011E 0E01 
0120 CD0500 

0123 FEOO 

0125 CA1E01 

0128 C30000 



GRAF 

CINP 
BDOS 



ORG 
EQU 

EQU 
EQU 



00100H 
0000CH 

001H 
00005H 



/Graphics Manager 
;entry point 

/Character input routine 
;CP/M BDOS entry point 



;Set the viewport and draw a border on the screen 



SETVP 



MVI 
MVI 



A,002H 
C,0C1H 



LXI H,VP 
CALL GRAF 



;Select rectangle routine 
; Command byte 
;for viewport 
;Point HL to 
/viewport coordinates 
;Call Graphics Manager 



;Draw a rectangle rotated 45 degrees 

DRAW LXI B f 0140H /Rotation will r r v ^ 

? occur around 
LXI D,0078H ;the center of 

LXI H r 45 ;Rotate 45 degrees 
DB 0D9H ;Move values to 

;alternate registers 

!•;...';'..... -'jIVI A f 00AH /Select extended 

;rectangle routine 

MVI C,051H /Value for shading 

/interior 

LXI H,RECT /Point HL to 

/rectangle coordinates 

CALL GRAF /Call Graphics Manager 

/Loop through this routine until the user 
/types a key on the keyboard. Then return 
/to CP/M 



LOOP MVI C,CINP 

CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to CP/M input code 

Call CP/M to 

get a character 

If zero, no 

key was typed 

If no key was 

typed, loop 

Re-enter CP/M 

via warm boot 
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EXAMPLE 4 - RECTANGLE USING EXTENDED ROUTINE (continue^) 



;These values are the coordinates for the 
;viewport 



012B 0000 
012D 0000 
012F 7F02 
0131 EF00 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;x 


maximum 


DW 


00EFH 


;Y 


maximum 



;These values are the coordinates for the 
;rectangle 



0133 B000 
0135 6000 
0137 D001 
0139 9000 



RECT 



DW 


00B0H 


;xi 


DW 


0060H 


;Y1 


DW 


01D0H 


;X2 


DW 


0090H 


;Y2 



013B 



END 



X AXIS PIVOT 



i**x*x*xX 

ymX*X+X*X*X*XV 
WM«X»X*X*XM*X*X»v 



d**X*X 

/xmx x : 

«M*X*X 



..(x*x*x*x«*:«x*x«mxmx^.. 
,*>xmx*x*x+x*x«mxmx*x*x«x 

*XmxmX*X?X*X«»X*X«««m 

xmx*xmxmx*x*x*x*xmx»x*x 

^IlllliiliP^ 

^M«*X.«*«XiX.«JXJXiXJXJXSX 



X*' 




X»X*XtX«X*X*X+X# 

mmmr 

♦XSxSXyX+Xi^ 
'♦XiXi*?X"$*$X**W*jj*Wh^ 



jrtXMM 

MXtXtXtJfM 

...»X*X«t«WXMjX' .... 

x»x*x«*xmxSx*x*xM 



x«x«x»x«x«x«x»x*x*x4 
.. jmxmxmx 

♦XMmXtXMM? 



1*' 

drtt*! 

^♦x*x*x*x*x«*x*x*: 



Ait 

>xm 



;*XmX*XmX+X»XM»X«tmXM 

..tX4X«XtXtXtX«X«XM4XtX4XtX4Xf 

...♦X»X*X*X«»X*X*X?X»X«M«*X*X 

X*X*X»X*X*X*X+X*X*X*X*X*X»X*X»Xi 

- x+xmx»x+xmx+xmxmx»x»X'' * 

x»x»x*x»x*x*x*x*x*x*xmx*r " 

XM«*xmx«t*xmx«t*; 

tX*XtXtX*X4XtxmxW 

xtx*x+x»x*x+xmxi 

'**mm 



>x*x»x*x»x««*xmx*xmx*y 
-«$XM«*xmx«t*xmx«t*i' 

^#X+X*XM«mX?X«(*^ 
XX*X»X*X*X4X4XiXr 
•AX«*X 

X»x*: 
^s*x 



v^r 




45° ROTATION 



Y AXIS PIVOT 



FIGURE 4 
ROTATED RECTANGLE 
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EXTENDED ELLIPSE DESCRIPTION 



Section 3.13 



Introduction 



B 

C 
D 

E 

HL 

IX 

IY 

BC* 



DE 1 



HL' 



This section describes how to set the registers 
for the extended ellipse routine. Additional 
information is provided in Section 6.3 of the 
Graphics CP/M Preface. 



REGISTER VAL UE 
A 11 



Type of ellipse 



Command byte 



Table address 
Start angle 
Stop angle 
Horizontal radius 



Vertical radius 



Rotation angle 



DESCRIPTION 

Designates the 
ellipse routine 



extended 



See the Graphics CP/M 
Preface manual for a 
description of values 
used with these registers 



Not used 



See the Graphics CP/M 
Preface manual for a 
description of values 
used with these registers 

Half the value of the 
horizontal radius. 
A number within the range 
of -32768 to 32767. 
This value is doubled 
in the resulting figure. 

The value of the 
vertical radius. 
A number within the 
range of -32768 to 32767. 

A value within the range 
of -32768 to 32767. 
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EXAMPLE 5 - E LLIPSE U SING REGULAR ROUTINE 



Section 3,14 



0100 

oooc = 

0001 = 
0005 = 



0100 3E02 
0102 0EC1 

0104 212701 

0107 CDOCOO 

010A 3E03 

010C 0600 
010E 0E51 

0110 1648 

0112 1E18 

0114 212F01 

0117 CDOCOO 



011A 0E01 
011C CD0500 

011F FEOO 

0121 CA1A01 

0124 C30000 



ORG 00100H 

GRAF EQU OOOOCH 

CINP EQU 001H 

BDOS EQU 00005H 



;Graphics Manager 
;entry point 

;Character input routine 
;CP/M BDOS entry point 



;Set the viewport and draw a border on the screen 



SETVP MVI A,002H 
MVI C,0C1H 

LXI H,VP 

CALL GRAF 

;Draw an ellipse 

DRAW MVI A,003H 

MVI B,000H 
MVI C,051H 

MVI D,048H 

MVI E,018H 

LXI H,ELLIP 

CALL GRAF 



;Select rectangle routine 
; Command byte for 
;viewport with border 
; Point HL to 
/viewport coordinates 
;Call Graphics Manager 



Select original 
ellipse routine 
Specify a whole ellipse 
Value for shading 
the interior 
Set the 1/2 the 
horizontal size 
Set the 1/2 the 
vertical size 
Point HL to 
ellipse coordinates 
Call Graphics Manager 



;Loop through this routine until the user 
; types a key on the keyboard. Then return 
;to CP/M 



LOOP MVI C,CINP 
CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to CP/M input code 

Call CP/M to get 

a character 

If zero, no 

key was typed 

If no key was 

typed, loop 

Re-enter CP/M 

via warm boot 
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EXAMPLE 5 - ELLIPSE USING REGULAR ROOTINE (continued) 



;These values are the coordinates for the 
;viewport 



0127 0000 
0129 0000 
012B 7F02 
012D EF00 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;x 


maximum 


DW 


00EFH 


;Y 


maximum 



;These values are the coordinates for 
;the ellipse 



012F 3F01 


ELL IP DW 


013FH 


;xi 


0131 7700 


DW 


0077H 


;Y1 



0133 



END 



i ;ilMH' H "l"MIHI H IHi| 

.wirmxTx+xmxmxmxmxtxtxmx,. 

Yfmxyxmx«Mt*XMx«xmx«*XMmx*XM«x«x* 



XmXtXtX+XflK- 

«*x*x*x?x«x?xTxv 

XMfrX+XMMHXmXft. 



.yX*X*XmXmxmxmX*XmX*XtX*X*XMX*XMXM 

w»xmxtx*xmxmxtx»xmxmxtxtxtxmxtxtxmx?xMtfx+xmxtxmx#K 

XWXmXWX WXmXtXMXmx¥x»X«X*XtXM*X«mX«X*X. 
iXWX«»X«mX*X«*X*X*X*X*X*X«mXMX«ttXi 

xmx*xwx|x?xmx*xm * 



FIGURE 5 
REGULAR ELLIPSE 
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EXAMPLE 6 - ELLIPSE USING EXTENDED ROUTINE 



Section 3.15 



0100 

oooc 


- 


0001 
0005 


= 


0100 
0102 


3E02 
0EC1 


0104 


212D01 


0107 


CD0C00 


010A 


014800 


010D 


111800 


0110 
0113 


212D00 
D9 


0114 


3E0B 


0116 
0118 


0600 
0E51 


011A 


213501 


011D 


CD0C00 



0120 0E01 
0122 CD0500 

0125 FEOO 

0127 CA2001 

012A C30000 



ORG 00100H 

GRAF EQU 0000CH 

CINP EQU 001H 

BDOS EQU 0000 5H 



; Graphics Manager 
; entry point 

;Character input routine 
;CP/M BDOS entry point 



;Set the viewport and draw a border on the screen 



SETVP MVI A,002H 

MVI C,0C1H 

LXI H f VP 

CALL GRAF 



;Select rectangle routine 
; Command byte for 
;viewport with border 
; Point HL to 
/viewport coordinates 
;Call Graphics Manager 



;Draw an ellipse rotated 45 degrees 



DRAW LXI B,0048H 

LXI D,0018H| 

LXI H, 045 
DB 0D9H 

MVI A,00BH 

MVI B,000H 
MVI C f 05lH 



LXI H,ELLIP 
CALL GRAF 



Specify 1/2 the 
horizontal size 
Specify 1/2 the 
vertical size 
Rotate 45 degrees 
Move values to 
alternate registers 
Select extended 
ellipse routine 
Specify a whole ellipse 
Value for shading 
the interior 

Note: registers D and E 
are not used 
Point HL to 
ellipse coordinates 
Call Graphics Manager 



;Loop through this routine until the user 
; types a key on the keyboard. Then return 
;to CP/M 



LOOP MVI C,CINP 
CALL BDOS 

CPI 000H 

JZ LOOP 

JMP 0000H 



Set C to CP/M input code 

Call CP/M to 

get a character 

If zero, no key 

was typed 

If no key was 

typed, loop 

Re-enter CP/M 

via warm boot 
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EXAMPLE 6 - ELLIPSE USING EXTENDED ROUTINE (continued) 



;These values are the coordinates for the 
;viewport 



012D 0000 
012F 0000 
0131 7F02 
0133 EF00 



VP 



DW 


0000H 


;x 


minimum 


DW 


0000H 


;Y 


minimum 


DW 


027FH 


;X 


maximum 


DW 


00EFH 


;Y 


maximum 



;These values are the coordinates for 
;the ellipse 



0135 3F01 


ELL IP DW 


013FH 


;xi 


0137 7700 


DW 


0077H 


;Yl 



0139 



END 



X AXIS PIVOT 



Am 



-A 



.♦x*xtxmx*xmx*x 

..*x*x*x«mx*x«m mxtx+xtf' 
*xmxwx«x*x*xmxjx*x*x»x> r 
xmx*x*x >x*x+x*x+x* 



Mmxmxwx+x+xmx 



rtX+X*XmX*X+X*XmX+Xm ' 
>X+X+XmXM*XmX*X*X*X 

timxtxmxtxmxmx 

J*X*X«XMX*XmX*X4'" 





45° ROTATION 



^x»x*x+x*x*xtx*x+x*xtxj 

yittX*XmxmX*X*XWX««X*x7 
^XmX+XMtXmxmX+XmX? 

j«xtx+xtxtx x x«x*xtx*x»?«*x*xj" 
,«*x»xtx*x+x?xtx*x«x*x+x?x*x*x 

<WX*XmXMMWX*XmX«»XW 
/JX*X*XmxmX*XmX*X*X*X«}(W 

..mx*x*x*x*x*x*x*x*x*x*x*x*x*x4 

+«U**MW(+*W4X+XtX«»X*X->X*X*»' 



mm 

X*X/ 

w 



Y AXIS PIVOT 



FIGURE 6 
ROTATED ELLIPSE 
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